Expand description
tzdb — Time Zone Database
Static time zone information for tz-rs.
This crate provides all time zones found in the Time Zone Database, currently in the version 2023d (released 2023-12-22).
See the documentation for a full list the the contained time zones: https://docs.rs/tzdb/latest/tzdb/time_zone/index.html
Usage examples
// get the system time zone
let time_zone = tzdb::local_tz().unwrap(); // tz::TimeZoneRef<'_>
let current_time = tzdb::now::local().unwrap(); // tz::DateTime
// access by identifier
let time_zone = tzdb::time_zone::europe::KYIV;
let current_time = tzdb::now::in_tz(tzdb::time_zone::europe::KYIV).unwrap();
// access by name
let time_zone = tzdb::tz_by_name("Europe/Berlin").unwrap();
let current_time = tzdb::now::in_named("Europe/Berlin").unwrap();
// names are case insensitive
let time_zone = tzdb::tz_by_name("ArCtIc/LongYeArByEn").unwrap();
let current_time = tzdb::now::in_named("ArCtIc/LongYeArByEn").unwrap();
// provide a default time zone
let current_time = tzdb::now::local_or(tzdb::time_zone::GMT).unwrap();
let current_time = tzdb::now::in_named_or(tzdb::time_zone::GMT, "Some/City").unwrap();
Feature flags
fallback
(enabled by default) — compile for unknown target platforms, too
Re-exports
pub use tzdb_06::raw_tz_by_name;
pub use tzdb_06::time_zone;
pub use tzdb_06::tz_by_name;
pub use tzdb_06::TZ_NAMES;
pub use tzdb_06::VERSION;
pub use tzdb_06::VERSION_HASH;
Modules
- Changes between the versions
- Get the current time in some time zone
Functions
- Find the time zone of the current system